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SECTION A TI-99/4A CONSOLE 



A.l GENERAL DESCRIPTION 



The purpose of this section is to provide necessary information concerning the 
I/O bus (input/output signal connection) of the TI-99/4A console for persons 
interested in designing peripherals for the computer. Also included are the 
description and schematics of the modified Home Computer console called the 
TI-99/4QI. Both the 99/4A and the 99/4QI function almost identically' 
Throughout the text, references to the 99/4A are applicable to the 99/4QI 
Schematics and component placement diagrams are specifically labeled as either 
99/4A or 99/4QI. J 

It is assumed that readers of this manual have a working knowledge of 
electronics and computers, especially in regard to the TMS 9900 microprocessor 
and its Communications Register Unit (CRU) I/O technique. Sources for this 
information are the TMS9900 Microproce ssor Data Manual (MP001, Revision A) or 
the TMS9901 Programmable Systems Interface TTTOTTJuTy . 1978). These books 
may be obtained from TI semiconductor distributors or the TI Learning Center. 
A glossary is provided on page 57 of this manual. 

The I/O bus provides an interface between the console and its peripherals. 
This bus utilizes both memory-mapped I/O and CRU I/O. The memory bus is 
frequently used for instruction fetch from read-only memory (ROM) in external 
peripherals and for data transfer to and from memory-mapped portions of these 
devices. The CRU bus is used for peripheral enable/disable, device control, 
and data transfer to/from CRU-mapped portions of these peripherals. 

The TMS 9900 microprocessor accesses each peripheral to obtain instructions 
from the device service routine (DSR) ROM. Since each peripheral contains its 
own DSR, the TI-99/4A does not have to be designed to anticipate future 
peripheral requirements. The dual I/O bus capability, interrupt handling, and 
external DSRs provide flexibility at low cost. 
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A. 2 I/O PIN DESCRIPTION 



SIGNATURE 


PIN 


I/O 


AO (MSB) 


31 


Out 


Al 


30 


Out 


A2 


20 


Out 


A3 


10 


Out 


It A 

A4 


7 


Out 


A5 


5 


Out 


A6 


29 


Out 


A7 


17 


Out 


A8 


14 


Out 


A9 


18 


Out 


AlO 


6 


Out 


All 


8 


Out 


A12 


11 


Out 


A13 


15 


Out 


A14 


16 


Out 


A15/CRUOUT 


19 


Out 



DESCRIPTION 



ADDRESS BUS 

AO through A15 comprise the address bus. 
This bus provides the 16-bit memory 
address vect or to the external memory 
system when ME MEN is active. Address 
bit 15 is also used for CRU* DATA OUT 
on CRU output instructions. 



DO (MSB) 

Dl 

02 

D3 

D4 

D5 

D6 

D7 



D8IN 

w 



MBE 



CRUCLK 
CRUIN 



37 
40 
39 
42 
35 
38 
36 
34 



32 
9 



26 
28 



22 
33 



I/O 
I/O 
I/O 
I/O 
I/O 
I/O 
I/O 
I/O 



Out 
Out 



Out 
Out 



DATA BUS 

DO through D7 comprise the bidirectional 
data bus. This bus transfers memory data 
to (when writing) and from (when read ing) 
the external memory system when ME MEN is 
active. 



BUS CONTROL 

MEMory ENable. 'METCN indicates a memory access. 

Data Bus IN. When active (high) the data 
buffers and 9900 are in the input mode. 

Write Enable. W indicates a memory write. 

Memory Block Enable. MBE indicates a memory 
access in memory block 4000-5FFF. 



Out CRU CLocK. Indicates a CRU Write operation. 

In CRU data IN. Input data line to the Home 
Computer. 
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I/O PIN DESCRIPTION (CONTINUED) 

SIGNATURE PIN I/O DESCRIPTION 



READY 



IAQ 



12 



In 



41 Out 



MEMORY CONTROL 



READY (when MEMEN is active) indicates external 
memory is ready for a memory access. 

Instruction AcQuisition indicates the CPU is 
acquiring an instruction during the current 
memory cycle. 



TIMING AND CONTROL 



TMD 



RESET 



ETTTnT 



73 



GND 



SBE 

AUDIO IN 
+5 

-5 



13 In 



24 



Out 



In 



21,23 
25,27 



When active, LOAD causes the CPU to execute a 
nonmaskable interrupt; memory addresses FFFC 
and FFFE contain the new workspace and PC 
vectors, respectively. 

When active, RESET causes the Home C omputer and 
the peripherals to be reset. RESET will be 
held active for a minimum of five clock cycles. 

EXTernal INTerrupt. When active, EXT TnT causes 
the CPU to execute an interrupt. 



Out CPU Clock. Phase 3 of the CPU clock. 
POWER 



Ground reference. 



SPEECH MODULE SIGNALS 



■ 



l l 



44 
1 

43 



Out 
In 



Speech Block Enable. SBE indicates a memory 
access in the speech memory. 
Input for the audio from the speech module 
Supply voltage (+5v Norn) for speech module 
(50ma Max)* 

Supply voltage (-5v Norn) for speech module 
(50ma Max)* 

* NOTE: Pins 1 and 43 are not intended for use by consumer. Overload may 
cause permanent damage to console. 

- 
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A. 3 MEMORY ALLOCATION 




The memory address space is broken into eiqht blocks nf J* h„t 
The th rd block (addro«P«: annn ^n-\ • . DI0CKS ot 8K °ytes of memory. 
1/0 port for the periph"alf° IHe JLjL Pr S5! ded made avail ^le at\he 
(addresses 2000-3FFF Snd A000-FF F) are n tl?k 5eve ? th » ™ d eighth blocks 
Fjor the speech module ^addresses 9(00 S/rn T y ^P ans1 0" Peripheral, 

the I/O port. Addresses 9000-9/IF), a predecoded line is available at 

.SYST EM MEMORY MAP 
HEX ADDRESS 



0 

2000 
4000 

6000 
8000- 
A000- 
C000- 
E000- 



-1FFF 
-3FFF 
-5FFF 
-7FFF 
-9FFF 
-BFFF 
■DFFF 
-FFFF 



Console ROM space 

Memory Expansion Peripheral 

Peripheral Expansion (predecoded to I/O cormertn^ 
Cartridge ROM /RAM (predecoded to GROM connector) 
Microprocessor ROM, VDP, GROM, SOUND and SPEECH 
Memory Expansion peripheral Se 
Memory Expansion peripheral 
Memory Expansion peripheral 



MEMORY-MAPPED DEVICES 



ADDRESSES 
HJ0T5 




8400 
8800 

8802 
8C00 
8C02 
9000 

9400 
9800 
9802 
9C00 
9C02 



AO 


Al 


A2 


A3 


A4 


A5 


A14 


1 


o 


0 


0 


0 


0 


0 


1 


0 


0 


0 


0 


1 


0 


1 


0 


0 


0 


1 


0 


0 


1 


0 


0 


0 


1 


0 


1 


1 


0 


0 


0 


1 


1 


0 


! 


0 


0 


0 


1 


1 


1 




0 


0 


1 


0 


0 


0 


1 


0 


0 


1 


0 


1 


0 


l 


0 


0 


1 


1 


0 


0 


1 


0 


0 


1 


1 


0 


1 


1 


0 


0 


1 


1 


1 


0 


1 


0 


0 


1 


1 


1 


1 



IS 



USE 

TnTerrial RAM 

(83O0-83FF) 
Sound 

VDP Read Data 
VDP Read Statu: 
VDP Write Data 
VDP Write Address 
Speech Read 
Speech Write 
GROM Read Data 
GROM Read Address 
GROM Write Data 
GROM Write Address 

StLn?J7~T5 ed ^ Vices at addresses >8000 through >9FFF are onlv 
block. For more information, see Section 



other addresses within the IK 
B.l on page 25. 



A. 4 CRU ALLOCATION 



Of the available 4K of CRU bits, the first IK (addresses 00Q0-07FE) are used 
internally in the console. The second IK (addresses Q800-0FFE) are reserved 
for future use. The last 1 . 9K (addresses 1000-1FFE) are reserved for the 
peripherals to be pluyyed in the I/O port. A block of 128 LRU bits is 
assigned to each peripheral as listed below. 

CRU ASSIGNMENTS 



CRU 



ADDRESSES 


A3 


A4 


A5 


A6 


A7 


USE 


0000-0 M-L 


0 


X 


X 


X 


X 


ik til 

Internal Use 


1000-10FL 


l 


0 


0 


0 


0 


Unassigned 


1100-11FE 


1 


0 


0 


0 


1 

1 


Disk Control ler Card 


l200-l2Ft 


l 


0 


0 


1 

1 


u 


Reserved 


1300-13FE 


l 


0 


0 


1 


1 


RS 232 (primary) 


1400-14FE 


l 


0 


1 


0 


0 


Unass i gned 


1500-15FE 


l 


0 


1 


0 


1 


RS 232 (secondary) 


1600-16FE 


l 


0 


1 


1 


0 


Unassigned 


1700-17FE 


l 


0 


1 


1 


1 


HEX-BUSTM 


1800-18FE 


l 


l 


0 


0 


0 


Thermal Printer 


1900-lFFE 


l 


1 


0 


0 


0 


Reserved 


1A00-1AFE 


l 


1 


0 


1 


0 


Unassigned 


1B00-1BFE 


l 


1 


0 


1 


1 


Unassigned 


ICOO-ICFE 


l 


1 


1 


0 


0 


Video Controller Card 


IDOO-IDFE 


l 


1 


1 


0 


1 


IEEE 488 Controller Card 


1E00-1EFE 


l 


1 


1 


1 


0 


Unassigned 


IFOO-IFFE 


l 


1 


1 


1 


1 


P-Code Card 



A. 5 INTERRUPT HANDLING 

The interrupt available on the I/O port is one of the maskable in 
the TMS 9901 Proyrammable Systems Interface. 




of 



9900 INTERRUPTS 



INTERRUPT 

LEVEL 
(Highest 
Priority) 
0 

1 



VECTOR LOC. 

(MEMORY ADDR. CPU 
IN HEX) PIN 
0000-WSP RE SE T 

0002-PC 

FFFC-WSP LOAD 

FFFE-PC 

0004-WSP 

OOOb-PC 



DEVICE 
ASSIGNMENT 
RESET 

LOAD 

EXT DEV (9901) 



Interrupting is done only on Level 1. The additional interrupts available are 
implemented on 9901. Interrupt Level 1 is decoded by software to be either 
VDP vertical sync, (2) 9901 internal timer, or (3) I/O bus generated. 
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ADDRESS 



0000 
0002 
0004 



0006 

0008 

000A 

OOOC 

OOOE 

0010 
0012 
0014 
0016 
0018 
001A-1E 



C7 * l> % 



^\DDRESS 

0020 
0022 
0024 

0026 
0028 
00 2A 
002C 

002E 

0030 
0032 
0034 
0036 
00 3 8-00 3E 



CRU BIT 



0 
1 



9901 
9901 



BIT ORG ANIZATION 
PTN 



2 
3 



Cont rol 

TNTT 

TnT? 

InTJ 



17 
18 

9 



"Function 

Control 

External Interrupt 
Video Display Processor 
Vertical Sync Interrupt 
9901 Internal Timer Interrupt 



4 

5 
6 

7 



INT4 

TnTB" 
TNT6" 



10 
11 
12 

13-15 



TNT7 (P15) 
TnT8 (P14) 

"TMi— i II a. mm i ' 

im (pi3) 

TnTIO (P12) 
INT11 (PH) 
TNTT? (P10) 
im3-INTT5 



I 



8 

7 

6 

34 

33 
32 
31 
30 
29 

28,27 
and 23 



1 ine, 
1 ine, 



keyboard 
joyst ick 
Keyboard 
joystick 
Keyboard 
joystick 
Keyboard 
joystick 
Keyboard 
joystick 
Keyboard 
Keyboard 

Keyboard "Z" line 
Not Used As Interrupt 
Reserved, High Level 
Not Used As Interrupt 



=" line, 
F IRE" 

Space" 
Left" 

"ENTER" 
Right" 
0" line, 
Down" 

FCTN" line, 
Up" 

SHIFT" line 
"CTRL" line 



ll 



ll 



ll 



ll 



ll 



ll 



ii 



9901 I/O MAPPING 



CRU BIT 9901 


PIN 


16 


PO 


38 


17 


PI 


37 


18 


P2 


26 


19 


P3 


22 


20 


P4 


21 


21 


P5 


20 


22 


P6 


19 


23 


P7 (INT15) 


23 



24 
25 
26 
27 
28-31 



P8 (INT14) 
P9 ( TNTT? ) 

P10 (INT12) 
Pll (TRTTT) 
P12-P15 



27 
28 
29 
30 

31-34 



FUNCTION 

Reserved 
Reserved 

Bit 2 of Keyboard Select 

Bit 1 of Keyboard Select 

Bit 0 (MSB) of Keyboard Select 

Keyboard (ALPHA LOCK) 

Cassette Control 1 

(motor control) 

Cassette Control ?. 

(motor control) 

Audio Gate 

Hag Tape Out 

Reserved 

Mag Tape Input 

Not Used IN I/O Mapping 
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A. 6 ELECTRICAL CHARACTERISTICS 
DRIVE CAPABILITY OF I/O SIGNALS 



SIGNAL NAME 
75 



CRUCLK 
WF 
AO 
Al 

DBIN 
MBF 

mEmTn 

A3-A14 
DO-D7 

A15/CRUOUT 
SBE 
HOLD 
RESET 

I/O READ 



DRIVER 

74LS244 

74LS244 

74LS244 

74LS244 

74LS244 

74LS04 

74LS244 

74LS32 

74LS367 

74LS245 

74LS244 

74LS03 

74LS32 

74LS04 



A CPU Read cycle for the external device consists of two 8-bit read cycles 
(Figure B). The two bytes read are assembled as a 16-bit word before they are 
presented to the 9900. Shown in Figure B are two 8-bit read cycles with one 
wait state inserted in each to work with slow memories. 

At the beginning of clock cyc le 1, MEMEN goes low true and DBIN goes high 
true. At the same time that MEMEN goes true, the address bus goes active. 
WE stays high false during the entire eye 1 



In order to eliminate noise and glitches (associated with crosstalk and 
simultaneous switching), a mini mum of 100 nanoseconds should be allowed for 
the address lines to settle. MBE (predecoded from AO, Al, and A2) goes true 
during the leading edge of <b2 of clock cycle 1. Data read from the 
peripherals must be valid 750 nanoseconds after the start of clock cycle 1 



The CPU will look at the full 16-bit data bus during the leading edge of 01 
clock cycle 6. Under worst-case conditions, data must be valid 100 
nanoseconds before that time. 



of 



■ 



1 
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I/O WRITE 

Figure C shows a 16-bit I/O write cycle. As described earlier, it is composed 
of two 8-bit writes. A write cycle will always be preceded by an ALU cycle. 

MEMEN and DBIN go true (low) at the start of the cycle. A time of 100 
nanoseconds (min) is allowed for the address lines to settle. WF goes true 
(low) on the leading edge of #2 during the wait states and stays true for 666 
nanoseconds (TYP). 

During a Read or a Write the odd byte (LSBY) is accessed first, then the even 
byte (MSBY). A15/CRU0UT changes its state 1 microsecond (TYP) after the cycle 
is initiated. The second 8-bit write cycle is identical to the first 8-bit 
write. MBE stays true (low) during the entire (1.8 microseconds) cycle. 



I/O BUS LOADING 



TOTAL SWITCHING 



MAXIMUM PERIPHERAL 



SIGNAL 


LOAD (pF) 


LOAD ( 


DO-Dr 


210 


90 


A0-A2 


100 


90 


A3-A14 


100 


90 


A15/CRU0UT 


110 


100 


13 


110 


100 


RESET 


100 


90 


READY 


80 


70 


CRUIN 


125 


90 


CRUCLK 


100 


90 


MBE 


100 


90 


W 


100 


90 


SB£ 


35 


25 


DBIN 


100 


90 


MEMEN 


100 


90 


HOLD 


80 


70 
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CRU TIMING 



CRU interface timing is shown in Figure D. The CRUOUT cycle is 
composed of two clock cycles. When placed on the address bus AO 
through A14, the CRU bit address is allowed to settle for 100 
nanoseconds (min). CRUCLK is a 63 nanoseconds (max) low true signal 
which occurs on the trailing edge of 01 of clock cycle 2. CRUOUT data 
is valid at the start of clock cycle 1 and is latched by the CRUCLK in 
the respective peripheral. 

CRUIN also consists of two clock cycles of 666 nanoseconds (TYP). 
Again 100 nanoseconds is allowed for the address bus to settle. The 
CPU samples the CRUIN line on the leading edge of 01 of clock cycle 
2. Data must be valid 40 nanoseconds (min) before that. This implies 
an access time of less than 400 nanoseconds for CRUIN. 





BACK VIEW 




CASSETTE 



VIDEO 



RIGHT SIDE VIEW 




FIGURE E. CONNECTOR PIN IDENTIFICATION DIAGRAM 
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SECTION B— INTERFACE CONSIDERATIONS 



B.l— CPU REQUIREMENTS 



B.l.l General Comments 



The purpose of this section is to outline considerations necessary or 
advisable for hardware used for interfacing peripherals to the TI-99/4A. 

Required TI-99/4A timing is shown on pages 12-17 in Section A of this manual, 
and Section D includes details concerning the software requirements for 
peripheral interfacing. 

B.1.2 TI-99/4A Memory Space Organization 

The memory map of the TI-99/4A is as follows. The allocated spaces are shown 
in parentheses, and the actual memory space used is shown where applicable. 
This is notable of the memory-mapped devices (MMD) in the >8000 to >9FFF 
space. All of these devices reside in IK blocks, and block decoding is used 
to select them. Even though they are shown to respond at the base address, 
they will respond ANYWHERE in the IK block assigned to them. An example is 
the 256 byte SRAM which is decoded to respond at a base of >8000. This SRAM 
repeats at bases of >8100, >8200, and >8300, and software is written to 
conform to the >8300 base. Note that there is a given amount of space which 
cannot be used because of the basic space definition and the decoding used on 
existing products. 
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B. 1 .2. 1 



Before WRITE Considerations 



Jp!^f?MMnc[ ere ?J- READ t nd WRITE address es for most of the memory-mapped 

£2wiE D lJ;i 5 1S beC9USe the ™ S 9900 does a R ^ AD operation^ at the 

address re2is?erft S h, P t ri ft t0 WMtin ? t 2* lt ' Many of the MM ° S have Sterna! 
aaaress registers that autoi ncrement after either a READ or a WRITE 

dSl?ed 0 ?;« ! ,nfi S iJ U i? i " Crei, 5 n i , characteris tic of the MMD may not produce the 
£l£t^V«&" "* ^ 1nt ° ™»«**'o» when designs or 

The READ before WRITE exists because the 9900 is a word-oriented machine from 

rarHpVn^ CC K SS , h StdndP ^' nt -. The Several b ^e-oriented instructions are 
carried out by the machine in a word execution format, and the other byte in 
the word must not be altered. The machine itself must save the unaltered 
byte, concatenate the new byte with it, and return the word to memory The 
internal logic of the TMS 9900 is designed this way because it was to the 
and'wSrd'moves!" 01 ' adVantage to do this same READ bef °^ WRITE on both byte 

B. 1.2.2 Cartridge Memory Space 

The cartridge memory space at >6000 must be treated as if it is loqicallv 

rZnlrtti 1° th ? i"! ^H 9 * P ° rt - In the TI "99/4A, the GROM data bus is 
connected directly to the I/O data bus; this is not the true of the 

TI-99/4QI. DO NOT TRY TO ACCESS THE CARTRIDGE MEMORY SPACE FROM THE I/O PORT' 
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TI-99/4A Memory Map 



:>00( 



(8K BY) >1FFF 



1 Console ROM 

i 

I >2000 

: Used by 32K Mem Exp 
J (8K BY) >3FFF 

: >4ooo 

I DSR ROM Space 



(8K BY) >5FFF 



! >6000 

1 Cartridge Memory Space 
! (8K BY) >7FFF 

I 

! >8000 

i Console 256 byte RAM 

I (IK BY) >83FF 



I >8400 

! Sound Chip, 1 BY req'd 
I (IK BY) >87FF 

I — 

! >8800 

! VDP READ, 2 BY req'd 

I (IK BY) >8BFF 



! >8C00 

1 VDP WRITE, 2 BY req'd 
! (IK BY) >8FFF 



! >9000 

ISpeech Module READ Space 
! (IK BY) >93FF 

I 

! >9400 

i Speech Module WRITE Space 
i 

! (IK BY) >97FF 



1>9800 

! GROM READ, 2 BY req'd 
! (IK BY) >9BFF 

I 

:>9coo 

1 GROM WRITE, 2 BY req'd 

1 (IK BY) >9FFF 
i ] 

! >AOOO 

1 Used by 32K Mem Exp 

! (24K BY) >FFFF 
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B.1.3 CRU (Communications Register Unit) Space Definition 

* ^^^^ 

B. 1.3.1 Disallowed Instructions. 

The control signal "CRUCLK" is also not fully decoded. Because the 
most-Significant three address bus bits are not included in ?he decode 

^w^tse?: % isr 00 must be disaiiowed - ™- - 

KaM S I GNAL ^ AS^A^CRU^OPE RAT IOn!"^ KD BY CRUCLK ^ INTERPRET 

B.1.3. 2 CRU OUTPUT Definition. 

There is a single restriction on the definition of CRU OUTPUT bits for 

!fl a " s ! : tje h b «e address bit. This bit must be used to "plge in- DSR 
iSl M 5 wA f d * hould ' where Possible, be RESET by the Power-Up RESET 
line in the I/O Port. Thus, the DSR ROM will be "paged out" by a RESET 
operation. For more information, see the paragraph on DSR ROM CONSIDERATIONS. 

B.1.3. 3 CRU INPUT Definition. 

withtJL"? definiti ° n CRU Input lines, and one is free to define them 
within that peripneral space as desired. 

B. 1.3.4 Spare CRU Bit Use. 

Spare CRU bits may be put to good use as test bits. If spare INPUT and output 
bits are available, the ones used should be chosen so that spare iJpu?'s III 
be connected to spare OUTPUT'S (each pair displaced by the same amount from* 
the base) to form software FLAG bits. Otherwise snarP tmpiit? hffc iT* 
tied to VCC or GROUND in some manner that wiT be verifilf dllinll Jhf^ be 
routine execution for that peripheral. Spare OUTPuTbi s may bereft * " P 
eauipmen 6 TM^f ? °? a ? etCh pad *° be SKe& tot om " test 
JSC V t 1 oft" aVr 1 "^ US6fUl Wh6n C ° mbined With tes? 
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CRU MAP 



: >oooo 

! CPU TMS 9901 space 

i 32 lines required 
! >03FE 

I 

j >0400 

' Unassigned 

>0FFE 



; >iooo 

I For test equipment use 
! on production line 
! (128 Lines) 

! >10FE 

!>1100 

I Disk Controller 

i (128 Lines) 

! >11FE 



!>1200 



I 
I 
I 



Reserved 

>12FE 



:>1300 



i Primary RS232 

! >13FE 

!>1400 

1 Unassigned 

I >14FE 

I 

!>1500 

! Secondary RS232 

! >15FE 



:>i6oo 

i 
• 

i 
• 

i 


Unassigned 


>16FE 


:>i7oo 

i 
• 

• 
i 


HEX-BUSTM 


>17FE 


:>1800 

i 
• 

i 
• 

i 


Thermal Printer 


>18FE 


!>1900 

1 
• 


Reserved 





! >19FE 



•■■^P •••• mmmm <*mp» M mm , ^\mm ^^^to 
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:>iboo • 

I Unassigned ! 

i >1BFE : 



I 



:>icoo : 

! Video Controller Card ! 

>1CFE ' 



I 



!>1D00 : 
I IEEE 488 Controller Card ! 
! >1DFE : 



I 



:>ieoo : 

Unassigned 

>1EFE ! 



! Unassigned ! 

i 



i 

i 



1 P-Code Card 1 



/ 




B.1.4 TI-99/4A Peripheral Polling 

The TI-99/4A polls the I/O Port for the presence of peripherals on either a 
S ?£™ are !; estar 1 or a hardware RESET. This polling starts in the CRU space at 
>1000, and continues in increments of >100 until >1F00 has been polled 
Power-up routines will be executed for each peripheral as its DSR ROM is 
polled (if the DSR header indicates that a power-up sequence is required). 

B.1.5 Indicator LED 

An indicator LED shall be provided, and shall be driven by a unique CRU OUTPUT 
bit. If all CRU OUTPUT bits have been defined, it shall be acceptable to 
connect the LED drive to the DSR ROM page bit. This LED provides visual 
feedback to the user that the peripheral card is present and active. All 
cards presently marketed by TI must provide this indicator. The LED is amber 
or yellow. 

B.1.6 DSR ROM Considerations 

The DSR ROMs for all peripherals must be based at >4000 and may be contiguous 
through >5FFF. These ROMs must not respond unless the respective CRU DSR ROM 
page bit is set ON (set to a high level with either a SBO instruction or "1" 
data in a LDCR instruction). It is the responsibility of the CPU to insure 
the proper control of all of the DSR ROM page bits. 

B. 1.6.1 Extended DSR ROM Techniques. 

a ROM Space in excess of 8K bytes may be obtained by bringing sequential 8K 
W blocks into the DSR ROM page. Secondary blocks (pages) may be placed anywhere 
in available TI-99/4A Memory Space. The secondary page bit may be obtained 
from the assigned CRU space to that peripheral (as was done on the P-Code PCB) 
or by writing to a ROM address and then decoding that condition to strobe a 
flip-flop. The latter method was used on the Extended Basic cartridge to page 
the upper 4K half of that space. Either a data bus or an address bus bit may 
be used for data to the FF. Both schemes provided a nonpaged 4K base ROM, and 
paged the upper 4K half of the space. 
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B. 2— EXPANSION UNIT REQUIREMENTS 



B.2.1 System Bus Requirements 

There are only two design considerations that must be understood to interface 
with the system bus. One controls a Data Bus driver on the TI-99/4A end of 
the connecting cable, and the other is used during printed circuit board (PCB) 
burn-in. 

B.2.1.1 Remote Data Bus Driver. 

I As has been previously noted, there are additional requirements for 

interfacing through the Peripheral Expansion Unit (PEU). Regardless of the 
processor driving the PEU, a signal must be provided to indicate to the 
interface that a memory cycle is being requested for a PCB in the PZU. This 
signal is termed "RDBENA* " , and is used to enable Data Bus drivers on the 
TI-99/4A end of the cable. It must function as an open-collector signal, but 
a tri-state gate may be used instead if the input is grounded and the 

tri-state controller is connected in parallel with that gate for the Data Bus 
Buffer. 

B.2.1.2 Burn-In Consideration. 

A single high true line shall be provided to enable the PCB to respond to both 
memory and CRU accesses. This line is held at a high level in the PEU, but is 
driven to allow a parallel connection of 16 PCBs during burn-in. When low, 
this signal shall disable the PCB from driving any of the system memory and 
CRU bus lines. The interrupt sensing has been excepted from this in the past. 

B.2.2 Power Allocation Assumptions 

The following is a guide for maximum load current a PCB should present to the 
• E U • | 

o 250 ma on the +15v unregulated bus. 
o 500 ma on the +8v unregulated bus. 
o 30 ma on the -15v unregulated bus. 
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Bus Pin Definition 



PIN SPACING, ATTLEBORO CONNECTOR 



MNEMONIC FUNCTION 

+5v 3-T Regulator supply voltage 
+5v 3-T Regulator supply voltage 

6ND Logic Ground 

READY A System READY 

GND Logic Ground 

RESET* Active LOW system-driven RESET 

GND Logic ground 

SCLK System clock 

LCP* Second generation CPU indicator. 

0=Second generation CPU; l=TI-99/4 

AUDIO Input audio 

RBDENA* Active LOW remote data bus driver 

Enable control line 
PCBEN Active HIGH PCB enable for burn-in 

HOLD* Active LOW CPU HOLD request 

Second generation CPU only 
IAQHA IAQ HOLDA logical OR 

Second generation CPU only 
SENILA* Interrupt Level A Sense Enable 

SENILB* Interrupt Level B Sense Enable 

Second generation CPU only 
INTA* Active LOW Interrupt Level A 

LOAD* Low for TI-99/4 Memory Expansion, 

High for linear memory space. 

Second generation CPU only. 

TMS9900 LOAD* input 
07 System DATA Bus, LSB 

GND Logic Ground 

D5 System DATA Bus 

D6 System DATA Bus 

D3 System DATA Bus 

D4 System DATA Bus 

Dl System DATA Bus 

D2 System DATA Bus 

GND Logic Ground 

DO System DATA Bus, MSB 

A14.A Address Bit 

A15/CRU0UT.A Address Bit, LSB 
A12.A Address Bit 

A13.A Address Bit 

A10.A Address Bit 
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System Bus Pin Definition (Continued) 



NO 


MNFMON TP 
rill LrlUIN 1 b 




All A 


35 


A08 A 


36 


A09.A 


37 


A06.A 


38 


A07.A 


39 


A04.A 


40 


A05.A 


41 


A02.A 


42 


A03.A 


43 


A00.A 


44 


A01 A 


45 


AMR A 


46 


AMA A 


47 


GND 


48 


AMC.A 


49 


GND 


50 


CLKOUT* 


51 


CRUCLK.A* 


52 


DBIN A 


53 


GND 

Mil \J 


54 


ri L • M 


55 


PRIITN 

Ul\ U in 


56 


MEMEN.A* 


57 




58 




59 




60 





FUNCTION 



Address Bit 
Address Bit 
Address Bit 
Address Bit 
Address Bit 
Address Bit 
Address Bit 
Address Bit 
Address Bit 
Address Bit 
Address Bit 

Address Bit, normally HIGH 
Address Bit, normally HIGH 
Logic Ground 

Address Bit, MSB normally HIGH 
Logic Ground 
Active LOW CPU CLOCK 
Active LOW CRU Output Clock 
Data Bus Dir'tn, HIGH is CPU READ 
Logic Ground 

LOW true CPU Write Enable 
HIGH true CRU Input data 
Active LOW memory request 
~12v 3-T Regulator supply voltage 
-12v 3-T Regulator supply voltage 
+12v 3-T Regulator supply voltage 
+12v 3-T Regulator supply voltage 
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B. 3— DESIGN AND DEVELOPMENT REQUIREMENTS 
This listing covers both hardware and PCB design rules. 

° KlhSi* b ? h C T le J? 1y d1 ? a 5 led b y a " active low disable (active 

on the PCB and k tll^lt T 6 ° th and CRU ^nctionf 

on tne pcb, and is used for burn-in purposes. 

o The +12v -5v, and -12 v power etches shall be double spaced from other 

SSJ'JSTJ P ° SSlb1e ; J h l S minimizes * TTL to power line sho?t or a 
power etch to power etch short. 

o Signals such as CRUIN that are taken very far from the system I/O 
connector shall be guarded with GROUND etch. Where practical these 
signals should be buffered with tri-state buffers practlcal ' tnese 

o Buffers to drive the bus must be physically close to the I/O Bus ThA 

rS^nd'rmnN'r 6 T* ° f IV s V ead * in SuV ?gna s such 

fS? f CRU ™ d0 not have them because they are not always used. 
A connection to the system bus constitutes a stub connection, which 

ITtZnl y ,° "f tr \ nsmi " ion line ^eory. These stubs should be kept 
as short as is practical. v 

o All 19 system address bits shall be included in the memory space decode 
for that peripheral. Assume AMC, AMB, and AMA to be in the high state. 

o Address lines A00 through A07 shall be included in the CRU Space decode 
even though the TI-99/4A assumes A00 thru A02 to be zero 

o There are two levels on which to interrupt, but the TI-99/4A sunn 0r t«; 
only one INTA*). THIS IS THE ONE YOU MUST USE. Interrupt level 
status bits are defined by the Personal Computer PCC at Texas 
Instruments, and for the moment are not sensed by the TI-99/4A If 
they were to be sensed, the TI-99/4A would cause a line to qo l'ow 
(SENILA*) , which tells the PCB logic to gate its status bit to the 
system ddtd bus. 
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Section C — FILE MANAGEMENT SPECIFICATIONS 

C.l Introduction 

This document contains a complete specification for the file management system 
of the TI-99/4A Home Computer. 

The text in this document has been completely revised to reflect changes that 
have been made to facilitate new options in the TI-99/4A Home Computer. 

The TI-99/4A Home Computer will support all file features described in this 
document. Some minor additions have been made concerning the status 
(C.3.2.10) and the error code section (C.3.4) to reflect changes for the 
TI-99/4A Disk Peripheral. These changes do not affect any DSR that currently 
exists. 

Section C.4.3 has been provided to give information to the GPL applications 
programmer on how to access DSRs and for the peripheral programmer on how the 
information is passed on a DSR. 
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C.2 I/O Handling 



The approach used in the TI-99/4A Home Computer File Management System has 
been that all devices should look the same to an application program. 
Therefore when peripherals are added to the computer, it should not affect the 
BASIC interpreter. Only the peripheral driver (Device Service Routine, or 
will have to be added to the software. 



All peripherals for the TI-99/4A Home Computer, with the exception of the 
keyboard/display, are considered equivalent by an application program, within 
physical limitations (reading data from a thermal printer is clearly 
impossible). These physical limitations are determined in the device service 
routine and returned to the application program as an error condition. 

The TI-99/4A Home Computer File Management System supports both random and 
sequential access files. Both file types use the same supervisor call 
mechanism in order to insure a high degree of device independence. Hardware 
devices (such as a line printer) are accessed as sequential files except that 
no file name is appended to the device name. 

The following sections describe the file structures available to the BASIC 
interpreter, how to create and delete files, and how to perform file I/O. 

Two different kind of file organizations are supported: 

o Sequential files j 
o Relative record files (random access) 

C.2.1 File Organization and Use 

The following paragraphs discuss the file organization and use for each of 
the two file types. 



C.2. 1.1 Sequential Files 



■ 



i 



Sequential files are both used for disk-based files and for I/O to other 
devices. They consist of fixed or variable record length files whose 
records are always accessed serially, like the output to the thermal 
printer. 

C.2. 1.2 Relative Record Files 

Relative record files are also called random access files because, unlike a 
sequential file, records may be accessed in an arbitrary order. Therefore 
relative record files can only be supported on random access media such as 
floppy disks. 
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I!2h2 C01 ?* Wlthln a relative re cord file are addressed by a uniaue record 
number. To access record X, the value X has to be placed in the 
appropriate field of the I/O Peripheral Access Block, "he range of record 
numbers is from zero to one less than the number of records In the file 

creaJlon 11 ! * relat1ve r6C ° rd f11eS are a fixed len 9 th - specified at f le 



Records in a relative record file can also be accessed in a sequential wav 
by specifying only the first record in the sequence. The sunervi^or thpn 
automatically updates the record number each time after a record has been 



C.2.2 File Management Overview 
C.2.2.1 Terminology 



A file consists of a collection of data groupings called loqical records 
This division of the file into logical records does not necessarily 

a°rf r Sr d TH t0 \ h h PhySiCa J dl ' Visi0n of data on the ^dium Oikl a sector on 
a disk). Thus there are two types of records: sector on 

o Logical records-The data grouping of a file as seen by an 
application program. y 

o Physical records-The buffers physically transferred between 
memory and medium. wetN 

Relative file I/O from a program is done on a logical record with a fixpd 
ength This enables the system to compute the actual location of any 
logical record relative to the beginning of file. y 

Sequential files allow both fixed and variable length records. 

When a file is created, the logical record size must be specified Fnr 
relative record files this size must be exact. For sequential files ?he 
specification indicates an upper limit for the size of a Variable record 
or the exact length of a fixed-length record. In case a zero i .npHf?^ 
for either filetype, the DSR must select a default ?" the record size 

Im^^nUt1on r ^ndenf. f0r "» ^ fi SP6Cified Within the DSR »• 
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C.2.2.2 File-Type Attribute 



The file-type attribute specifies the format in which the data in 
the file is represented. The two file types are: 

o DISPLAY— Displayable or printable character strings. 

Each data record corresponds to one print line. 

o INTERNAL — Data in INTERNAL machine format. ! 

The file-type attribute is internal to the application program. It is 
merely stored and passed on by the DSR as a distinction between two data 
types, without affecting the actual data stored. 

C.2.2.3 Mode of Operation 

A file is opened for a specific mode of operation, specified in the OPEN 
I/O call. The four modes of operation are: 

o INPUT - The contents of the file may be read, but may not be 

altered. 



OUTPUT - The file is being created. Its contents may be 

written but not read. 



UPDATE - 



The contents of the file may be both written and 
read. Note that this mode of operation is only be 
supported by random access devices. 



o APPEND - New data may be added at the end of the file, but the 

contents of the file may not be read 

Each DSR decides whether or not a specific mode for an I/O operation can be 
accepted by the corresponding device. 

C.2.2.4 Temporary Files 

In the subsets of TI standard BASIC used for the TI-99/4A Home Computer, 
the file-life attribute is not implemented. Therefore there is no need for 
the File Management System to support temporary files, and all files are 
permanent by definition. 
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C.3 Implementation 

As mentioned in section C.2, the DSRs should present a uniform interface 
between the File Management System and the peripherals. This section will 
give details about implementing this interface. 



C.3.1 Peripheral Access Block Definition 

All DSRs are accessed through a Peripheral Access Block (PAB). The 
definition for the PAB is the same for every peripheral. The only 
difference between peripherals, as seen by any application program, is that 
some peripherals will not support every option provided for in the PAB. 

All PAB's are physically located in VDP RAM. They are created before the 
OPEN call and are not to be released until the I/O has been closed for that 
device or file. 

Figure C.3. 1.1 shows the layout of a PAB. The PAB has a variable length, 
depending upon the length of the file descriptor. 

The meaning of the bytes and bits within the PAB is explained below. 



Byte 



Bit 



Meaning 



I/O opcode- 



Contains opcode for the current I/O 
call. A description of the valid opcodes 
are given in section C.3. 2. 



Flagbyte/status— All the information the system needs 

about file-type, mode of operation, and 
data-type is stored in this byte. The 
meaning of the bits within this flagbyte 
is: 



Msb ! 7 6 5 4 3 2 1 0 ! Lsb 

i i i i i i i i 

I ! ! ! i I ! '- Filetype 

: : ! : 1 ' — ' Mode of operation 

! ! ! ! ' Datatype 

i ! I ' Recordtype 

' — ' — ' Errorcode 
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Byte Bit 



Meaning 



1 0 Filetype — Indicates file-type. 

0 = Sequential file 

1 = Relative record file 

1,2 Mode of operation — Indicates operation mode for which 

file has been opened. 

00 = UPDATE 

01 = OUTPUT 

10 = INPUT 

11 = APPEND 

3 Datatype — Indicates type of data stored in the file. 

0 = DISPLAY type data i 

1 = INTERNAL type data 

4 Recordtype— Indicates type of record used. 

0 m Fixed length records 

1 = Variable length records 

5-7 Error code— These three bits indicate, in combination with 

the I/O opcode, the error type that has 
occurred (0 = no error). 

2,3 - Data buffer address— Address of the data buffer the data 

has to be written to or read from. 

•4 - Logical record length — Indicates the logical record 

length for fixed length records, or the maximum 
length for a variable length record (see 
f lagbyte) . 

5 - Character count — Number of characters to be 

transferred for a WRITE opcode, or the number 
of bytes actually read for a READ opcode (not 
equivalent to INPUT and OUTPUT mode). 

6,7 - Record number— Only required if the file opened is 

of the relative record type. Indicates the 
record number the current I/O operation is to 
be performed upon (this limits the range of 
record numbers 0-32767). The highest bit will 
be ignored by the DSR. 
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Byte 



Bit 



Meaning 



8 



9 



Screen offset— Offset of the screen characters in 

respect to their normal ASCII value. 

Name length— Length of the file descriptor followinq 

the PAB. 



10+ 



F'le descriptor— Device name and, if required, the 

filename and options. The length of this 
descriptor is given in 9. 



i 
i 
i 
i 



I/O OPCODE 



I 



1 FLAG / STATUS 



i 
i 

i 

i 
i 

i 
i 



2,3 



DATA BUFFER ADDRESS 



i 
i 
i 
i 
i 

• ' 
i 

i 

i 

• ' 
i 

i 



LOGICAL RECORD LENGTH 



I 



CHARACTER COUNT 



6,7 



8 



RECORD NUMBER 



SCREEN OFFSET 



« 



10 



9 



NAME LENGTH 



— mm 



I 

I 

' • 

I 
I 
I 

I 
I 



Figure C.3.1.1 PAB Layout 



C.3.2 I/O Opcodes 



This section describes the valid opcodes that can be used in a PAB. These 
valid opcodes are shown in Figure C.3.2.1. 



The following section will describe the general actions invoked by an I/O 
call with each of the I/O opcodes. Each I/O call returns any error codes 
in the FLAG/STATUS byte of the PAB. 
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Opcode 



Meaning 



uu 


OPEN 


n i 


CLOSE 




READ 


UJ 


WRITE 




RESTORE/REWIND 


05 


LOAD 


06 


SAVE 


07 


DELETE 


08 


SCRATCH RECORD 


09 


STATUS 



Figure C.3.2.1 1/0 Opcodes 



C.3.2.1 OPEN 



The 0 P E f operation should be performed before any data transfer operation 
except LOAD or SAVE. The file remains open until a CLOSE operation is 
performed. The mode of operation for which the file has to be opened 

■ mnnir b f Jj?3.! Cated in the fla 9&yte of the PAB . In case this mode is 
UPDATE, APPEND, or INPUT, the record length will be returned in byte four 
Any given non-zero record length will be checked against this stored 
length. For OUTPUT the record length can be specified, or a default can be 
used by specifying record length zero. 

For any device, an OPEN operation must be performed before any other I/O 

nncM atl ru* The DSR need only check the recor d length and I/O mode on an 
OPEN. Changing I/O modes after an OPEN may cause unpredictable results. 

C.3.2.2 CLOSE 

The CLOSE operation informs the DSR that the current I/O sequence to that 
UbK has been completed. 

After the CLOSE operation, the space allocated for the PAB may be used for 
other purposes. As long as a PAB is connected to an active device, the 
contents of that PAB must be preserved. 

If file or device is opened for OUTPUT or APPEND mode, an EOF (end of file) 
record is written to the device or file before disconnecting the PA3. 

C.3.2.3 READ 

The READ operation reads a record from the selected device and copies the 
bytes in the specified buffer. The buffer address is specified in PAB 
entry 2 and 3; the buffer size is specified in PAB entry 4. The actual 
number of characters stored is returned in PAB entry 5 (CHARACTER COUNT) . 

JL"cU« 9 i^l , be h d1sc nP a?d t ed? COrd the bUffer Sl2e ' the ™ a, " ( "9 
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C.3.2.4 WRITE 



The WRITE operation writes a record from the buffer specified in the PAB to 
Me S fi C ,e f o? tte PM. " mber ° f " yteS t0 be " Ht?en 15 " 

C.3.2.5 RESTORE/REWIND 

The RESTORE/REWIND operation repositions the file READ/WRITE pointer either 
to the beginning of the file, or, in the case of a relative record file to 
the record specified in bytes six and seven of the PAB. ' 

f^ EST ? R ?- Can onl y be used if the file is opened for INPUT or UPDATE mode 
For relative record files, a RESTORE could be simulated in any I/O mode bv 
specifying the record at which the file has to be positioned fn bytes six* 

indict EcSd.™' ^ I7 ° ° Perati ° n then'autoaiatlMlly^S til 
C.3.2.6 LOAD 

The LOAD operation loads an entire memory image from an external device or 
file into VDP RAM. All the control information the application program 
""tL h0Ul h be concatenated to the program image. NS^nLrmedia^buffers 
lo^atioS' 6 mem ° ry lma9e iS dumped startinq at the specified 

Ii , L L0 ^u° P r ation I s a stand - alor >e operation, i.e. the LOAD operation is 
used without a previous OPEN operation. ^ration is 

For the LOAD operation, the PAB needs to contain the following information: 
Bytes 2,3— Start address of the memory dump area 
Bytes 6,7— Number of bytes available. 

Aside from the I/O opcode and the file descriptor, no other PAB entry is 
required for a LOAD operation. y 



C.3.2.7 SAVE 



SAVE is the complementary operation for LOAD. It is used for writina 

i necessary control information 
should be linked to the memory image, so that the information plus proqram 
image use on contiguous memory area. Again, only a small part of the PAB 
is used . Aside from the usual information (I/O opcode and file 
descriptor), the PAB contains: 6 



Bytes 2,3— Start address of the memory area 
Bytes 6,7— Number of bytes to be saved. 



C.3.2.8 DELETE 



The DELETE operation deletes the specified file from the specified device. 
This operation also CLOSEs the I/O sequence. 

C.3.2.9 SCRATCH RECORD 

The SCRATCH RECORD operation scratches the specified record from the 
specified relative record file. The record to be scratched is specified in 
bytes six and seven of the PAB. This operation will cause an error for 
sequential files and devices. This operation is not currently supported by 
any device. 

C.3.2.10 STATUS 

This information can be asked for at any time, although some information is 
only meaningful if a file has been opened for access. 

To indicate the current status of the file, byte eight (SCREEN OFFSET) is 
used. Upon the DSR call byte eight should contain the usual screen 
characters base address. The DSR can use only this byte and is guaranteed 
not to destroy any other entry in the PAB. 

The meanings of the bits within byte eight after return from the DSR are: 



0 Logical end of file. If this bit is set, the file is at the end 
of its previously created contents. This is usually the case if 
the file has been opened for APPEND mode. Depending upon the 
mode of operation for which the file has been opened, data can 
still be written to the file (APPEND, OUTPUT or UPDATE mode). 
However, a "read" operation will cause an ATTEMPT TO READ PAST 
EOF error to occur. 

1 Physical end of file. If set, no more data can be written, since 
the physical limits of the device have been reached. Generally 
this means an end of medium has been detected on the device. 



2 Record type. If set, the record type is VARIABLE length. If 
cleared the record type is FIXED length. 

3 Filetype. If set, the file is a program file. If cleared, the 
file is a data file. 

4 Data type. If set, the data type is binary (INTERNAL). If 
cleared the data type is ASCII (DISPLAY) or file is program file. 

5 Reserved for the future use. Fixed to zero in the current 
peripherals. 

6 PROTECT flag. If set, the file is protected against 
modifications. If cleared, the file is not protected. 

7 File requested does not exist. A device will not set this bit, 
which means that on a device, any file exists. 

Bits two — seven are valid if the file has not previously been opened. Bits 
zero and one can only be used for files that are currently opened for 
access. A file that is not currently open for access should indicate a 
zero in these two bits. 

C.3.3 Error Codes 

The File Management System supports a number of error codes. They are: 



Error 
Code 

0 

1 



Meaning 

Bad device name; the device indicated is not in the system. 
Device is write protected. 

Bad open attribute such as incorrect file type, incorrect 
record length, incorrect I/O mode, or no records in a 
relative record file. 

Illegal operation; i.e. an operation not supported on the 
peripheral or a conflict with the OPEN attributes. 

Out of table or buffer space on the device. 

Attempt to read past the end of file. When this error 
occurs, the file is closed. Also given for non-extant 
records in a relative record file. 

Device error. Covers all hard device errors such as parity 
and bad medium errors. 

File error such as program/data file mismatch, non-existing 
file opened in INPUT mode, etc. 
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C.4 DSR Operations 



This section describes how a variety of DSRs should react on the different 
I/O calls. It also discusses detailed software operations descriptions 
such as available registers and memory. 

C.4.1 DSR Actions and Reactions 

In the Home Computer File Management System, several assumptions are made 
about the way in which DSRs should react on conditions such as errors, 
special I/O modes, defaults, etc. This section is intended to explain the 
reactions of a DSR on these conditions. 

C.4. 1.1 Error Conditions 

C.4. 1.1.1. Non-existing DSRs 

If a non-existing DSR is called by an application program, the File 
Management System will automatically return with the COND bit set. In this 
case, no DSR has actually been called, so the error code will show no 
errors. 

The DSR search mechanism of the File Management System takes care of 
searching for the requested DSR. It tries to match the file descriptor to 
the DSR entries in the system. The matching algorithm matches the end of 
the descriptor, or the first period, whichever comes first. This enables 
the applications program to add special information for the DSR in the file 
descriptor, such as filename, BAUD-rate, print-width, character set, etc. 

C.4. 1.1.2 DSR-detected Errors 

DSR-detected errors (see section C.3.4) should be indicated in the flag 
byte of the PAB. It is the application program's responsibility to clear 
this flag byte before every I/O call, and check it after the I/O call. 
This type of error is NOT indicated with the COND bit. 



The DSR may provide additional information about the error type in the I/O 
opcode byte, although it is good practice not to destroy the least 
significant four bits of this byte, since they specify the I/O call 

At no time should the DSR use bits zero — four of the flagbyte for error 
indication, since these bits might contain vital system information 
about the file device. 



C.4.1.2 Special I/O Modes 

To enable the application program to use special device-dependent 
functions, the File Management System DSR search algorithm only uses a 
well-defined part of the file descriptor for its search (see section 
C.4. 1.1.1) • The remainder of the descriptor may be used to indicate 
special device-related functions such as BAUD rate, print width, etc. It 
is advisable for a DSR to ignore descriptor parts it doesn't recognize, so 
that the same application program might be used for different devices. In 
the latter case it would handle specific device-dependent functions only if 
the device used was capable of performing them. If the descriptor dealt 
with a function not applicable to a particular device, the DSR would not 
recognize the descriptor and would ignore it. 

An example of a special I/O mode descriptor could be 

RS232.BAUDRATE=120C.DATABITS=7.CHECKPARITY. PARITY=ODD 
C.4.1.3 Default Handling 

Sometimes, especially if a file is opened for UPDATE, INPUT, or APPEND, it 
is useful to provide a default value for the record length. In the above 
cases, the application program will usually use the value specified on file 
creation. Therefore, if the application program does not provide a value 
for the record length, the DSR should provide this value for it. In case 
the application program does provide a record length, the DSR should check 
this value against the value given on record creation. An error should be 
indicated in case of incompatibilities between stored and provided record 
length. If logical record length is given as zero on OPEN, the DSR must 
provide a default record length. 

C.4.2 Memory Requirements 

Because of the limited amount of register memory (256 bytes of RAM), the 
register usage for DSRs has to be restricted to the following 
registers/memory to avoid interference with application programs 



o Registers RO— RIO of the calling workspace. 

o Memory locations >DA through >DF are available if the DSR is 

called in a non interrupt-dri ven mode, i.e. through a standard DSR 
entry. 

o A standard scratch area of 36 bytes, at locations >4A through >6D, 
has been assigned for DSR usage. 

The base address for CPU memory in the TI-99/4A Home Computer is >8300. To 
allow for future changes in this base address, it will be derived from the 
given value of the workspace pointer. This means the loss of one of the 
workspace registers for this purpose. 
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C.4.3 GPL Interface to DSRs 

The GPL interpreter interfaces to DSRs through the monitor. The GPL 
program that wants to access a DSR has to use the following GPL CALL 
sequence: 

CALL >10 
DATA 8 

This will cause the monitor to start searching for a DSR with the same name 
as the string pointed to by CPU location >56. This search routine will 
stop comparing names at the end of the given string or at the first 
imbedded period, whichever comes first. 

On the DSR side, CPU location >56 is left pointing at the first character 
behind the DSR name, i.e. a period or an end of string. CPU location >54 
contains the DSR name length (one word). To get the start address of the 
PAB in VDP RAM, the following formula has to be computed: 

CPU(>56) - CPU(>54) - >0A 

The result will point at the I/O OPCODE entry in the PAB. 

It is up to the DSR to check for any switches in the name. For this 
purpose the lengtn of the PAB name string has been given in the PAB. 
Comparing this length against the length given in CPU location >54 will 
show if the user specified more than just the DSR name. 

C.5 Linkage to BASIC 

This section describes the way the BASIC version of the Home Computer is 
linked to the File Management System. 

This section also describes how to access PAB's from GPL subroutines that 
are callable from BASIC and assume a PAB link structure has been set up by 
BASI C. 




C.5.1 BASIC PAB modifications 

Aside from the control information contained within the PAB, as already 
discussed in section C.3, BASIC adds four more bytes to the top of the PAB 
for specific BASIC-related control information. The new PAB structure 
within BASIC is drawn in Figure C.5.1, 
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FIGURE C.5.1 Modified PAB Layout 

The additional four bytes contain additional control information BASIC 
needs for its internal PAB linkage structure. The PAB's within the BASIC 
control structure form a simple linked list, which means each PAB has a 
pointer to the next PAB in the system. The last PAB in the list has a zero 
("0") link, indicating that it is at the end of the list. 

Bytes 0 and 1 in the BASIC PABs contain the link mentioned above. Byte 2 
contains the actual BASIC channel or file number (1-255); byte 3 contains 
the offset of the current data pointer within the data block. 

The offset indicated in byte 3 of the BASIC PAB indicates the position of 
the current data pointer within the data buffer given in bytes 6 and 7. If 
byte 3 equals zero, the current data buffer is "blank"; i.e. if in "read" 
mode, a new buffer has to be read in before any further processing but in 
"write" mode the entire buffer is still available for data storage. 
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If byte 3 is non-zero, it contains an "offset" within the data buffer. 
Added to the start address of the data buffer, it will give the actual 
address of the first data byte to be read or written. This is only the 
case if we have pending PRINT operations (the most recent PRINT ended on 
m.i. or m^.i) or p en ding INPUT operations (the most recent INPUT ended on a 
","). In all other cases, byte 3 will be zero. 



C.5.2 BASIC PAB Linkage 



As mentioned already, BASIC utilizes a simple linked structure for the 
management of its PAB's. Each PAB contains a link to the next PAB in the 
chain. In order to access the chain, we need to have a link to the first 
PAB in that chain. This link is given in CPU location >3C for GPL 
programs, which is equal to location >833C in 9900 assembly language. 

A graphical representation of the link structure could be: 
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FIGURE C.5.2 BASIC Link Structure 

Please note that all PAB's are located in VDP memory, whereas the initial 
link to them is located in CPU memory. Also note that although usually the 
PAB's will be allocated in lexical order, depending upon the program, they 
can be allocated in any arbitrary order. 
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Section D — DSR SPECIFICATIONS 

D.l Introduction 

This document describes the hardware and software interfaces betwPPn fh« 
conso e and peripherals of the TI-99/4A Home Computer family The ou^ose 
of this document is to provide a reference for third part es'who want tn 
design new peripherals for the TI-99/4A family. P ° W£mt t0 

D.l.l General Interface 

Each peripheral should include a nonvolatile Device Service Routine (DSR ) 
software package to drive the peripheral. The DSR communicates with thV 
console software through certain memory locations. The coSso?e JoftwS? 
sets up information in these memory locations and passes i? to the 
U S er T' e J ected P eri P"eral. From there on, the selected perlDheral's DSR 
should have the capability to interpret the information^ up by the 
conso e software, physically drive the peripheral, and pass the 
peripheral's data or status to the console software if Accessary 
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D.2 I/O BuS — The purpose of this section is to describe the pin assignments 
of the I/O Bus, funtions of I/O signals, sources of Output Signals, and 
destinations of Input Signals. 

D.2.1 I/O Bus Pin Assignments and Descriptions 

Description 



Pin No. 


Notation 


I/O 


1 


+5V 


0 


2 


SBE 


0 


3 


RESET 


0 


4 


EXTINT 


I 


5 


A5 


0 


6 


A 10 


0 


7 


A4 


0 


8 


All 


0 


9 


DBIN 


0 


10 


A3 


0 


11 


A12 


0 


12 


READY 


I 


13 


LOAD 


I 


14 


A8 


0 


15 


A13 


0 


16 


A14 


0 


17 


A7 


0 


18 


A9 


0 


19 


A15/CRU0UT 


0 


20 


A2 


0 


21 


GND 


0 


22 


CRUCLK 


0 


23 


GND 


0 


24 


03 


0 


25 


GND 


0 


26 


WE 


0 


27 


GND 


0 


28 


MBE 


0 


29 


A6 


0 


30 


Al 


0 


31 


AO 


0 


32 


MEMEN 


0 


33 


CRUIN 


I 


34 


D7 


I/O 


35 


D4 


I/O 


36 


D6 


I/O 


37 


DO 


I/O 


38 


D5 


I/O 


39 


D2 


I/O 


40 


Dl 


I/O 


41 


IAQ 


0 


42 


03 


I/O 


43 


-5V 


0 


44 


AUDIO IN 


I 



5V Power Supply 

Low when MPU read from >90XX or write to >94XX 
memory 

Master Reset, low active 
External Interrupt, low active 
Address Bit 5 
Address Bit 10 
Address Bit 4 
Address Bit 11 

Derived from MPlTs DBIN pin, same parity 
Address Bit 3 
Address Bit 12 

If device or memory is ready after being 

addressed by MPU in memory R/W cycle, device or 

memory should cause this input to go high 

To 9900' s LOAD pin 

Address Bit 8 

Address Bit 13 

Address Bit 14 

Address Bit 7 

Address Bit 9 

CRU Output/Address Bit 15, LSB 
Address Bit 2 
Signal Ground 

Inversion of MPU's CRUCLK pin 
Signal Ground 

Inversion of Phase 3 Clock 
Signal Ground 

Derived from MPU's W pin, same parity 
Signal Ground 

Low when MPU addressing >4000 — >5FFF Memory 
Address Bit 6 
Address Bit 1 

Address Bit 0, MSB 

Derived from MPU's MEMEN pin, same parity 
CRU Input to MPU 
Data Bus Bit 7, LSB 
Data Bus Bit 4 
Data Bus Bit 6 
Data Bus Bit 0, MSB 
Data Bus Bit 5 
Data Bus Bit 2 
Data Bus Bit 1 
MPU's IAQ pin 
Data Bus Bit 3 
-5V Power Supply 

To Sound Generator Controller's AUDIO IN pin 
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D.3 Hardware Structure of DSR 
w D.3.1 DSR ROM 

Normally, a DSR is written in the 9900 Assembly Language and is housed in a 
ROM, which is itself part of the TI-99/4A family's peripheral. All DSRs must 
begin at address >4000 and should not exceed >5FFF. All of the eight data 
pins of the DSR ROM must be buffered before being connected to the data bus of 
the I/O Bus. This buffer is enabled and disabled by a preassigned CRU output 
bit which is controlled by the console software, so that not more than one DSR 
is accessed at any time. 

D.3. 2 CRU Mapping 

The CRU I/O is used by the system to access the peripherals, if the speed of 
data transfer is not too crucial. The decoding format for the CRU addressing 
is indicated as: 

AO Al A2 A3 A4 A5 A6 A7 A8 A9 A10 All A12 A13 A14 A15/CRU0UT 
0 0 0 User ID Device CRU I/O Bit Decode 0 

The CRU address space, ranging from >0 to >1FFE with AO, Al, A3, and A15 

unused, is broken into eight blocks of 512 bits each. The User ID, indicated 

through the Address Decoding of A3, A4, and A5, represents each of the 512 Bit 
Block. They are assigned as follows: 

Assignment 
Console Use 

TI Peripheral Space No. 1 

TI Peripheral Space No. 2 

TI Peripheral Space No. 3 

TI Peripheral Space No. 4 

The standard device decoding through A6 and A7 gives a total of four device 
blocks within each User ID Block. The CRU I/O Bit decoding through A8-A14 
allows 128 addressable bits each of input and output. In the 128 CRU Output 
bits, the first bit, with A8-A14 all 0*s, is reserved for enabling the Data 
Buffer of the DSR ROM in each peripheral as mentioned in the last subsection. 
Setting this bit to logic one enables the DSR ROM, while setting it to logic 
zero disables the DSR ROM. 




MPU Address A3 A4 A5 

0000-0 3FE 0 0 0 

1000- 13FE 1 0 0 

1400-17FE 1 0 1 

1800-1BFE 1 1 0 

1C00-1FFE 1 1 1 



D.4 Software Structure of DSR 

A DSR must follow a specific format in order to communicate with the console 
software properly. The purpose of this predefined format is to let the 
console software have the least overhead and the DSR have the maximum 
flexibility in device servicing. 

A DSR, in general, contains the following elements: 

1. Symbol Definition Block 

2. Header and Linkage Block 

3. Power-up Routine (optional) 

4. Main Device Service Routine 

5. Interrupt Routine (optional) 

Each of the above elements will be discussed in detail in the following 
sections. 

D.4.1 Symbol Definition Block 

The Symbol Definition Block serves two purposes. First, it equates frequently 
used data or addresses with symbols for ease of recognition. Secondly, it 
specifies the CPU RAM location in a certain way so that each DSR can be used 
around future and existing CPU family members such as the TI-99/4 and the 
TI-99/4A with the least modification. The first purpose is common in every 
program, but the second one needs more explanation. 

Each model in this family has a different memory structure within the 
console. Therefore, care must be taken in handling memory addressing in a DSR 
so that the DSR can support future Home Computer models. The console software 
always enters the DSR through the instruction: 

BL *R9 

where R9 contains the DSR entry address. Upon entry of the DSR, the workspace 
pointer contains the beginning address of the Register File, which the console 
software uses. If all the CPU RAM's which the DSR may access are predefined 
with respect to this workspace pointer, the DSR does not have to know the 
memory map of each console. The DSR can address each CPU RAM through index 
addressing via the workspace pointer. For example, if you want to move the 
contents of a CPU RAM (having a displacement [DISP] with respect to the 
workspace pointer) to RO, do the following: 

ENTRY STWP R4 entry of DSR 



MOV at DISP (R4), RO 
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Some of the frequently used CPU 



PAD 
FAC 
ROLB 
R1LB 

OPCODE 
FLGSTS 
BUFADR 
LRECLN 

CHRCNT 

RECNUM 

SCNOFF 

OPTLEN 

DEVLEN 

PABVDP 

VWA 

6RD 



EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 



->EO 

PAD+4A 

PAD+E1 

PAD+E3 

FAC+O 

FAC+1 

FAC+2 

FAC+4 

FAC+5 

FAC+6 

FAC+8 

FAC+9 

FAC+10 

FAC+12 

>8C02 

>9800 



D.4.2 Header and Linkage Block 



RAM's symbols and locations are listed below. 

Jtlrt of 1 " TI -" /4A console 

start of 36 bytes available to nsp 

lower byte of RO 0 UbR 

lower byte of Rl 

PAB— Data Buffer Address 

PAB-Ugical Record Length 

PAB— Character Count 

PAB— Record Number 

PAB— Screen Offset 

PAB— Option Length 

PAB— Device Length 

PAB— Pointer to PAB in VDP RAM 

address for VDP Write-Address operation 

address for GROM Read-Data operatio^ 



The DSR 



the consolfsoWe ?a?te >Jtl!f fft * tartin 9 at >4000 so that the linkaoP 
following information: establl ^d properly. This header contains til 



1. 

2. 

3. 
4. 
5. 



validation flag ( >AA ) . 

name s) of device(s) being serviced by this DSR 
(the device name should be 7 rh*^^ V 
entry point(s) of the dev1c!f«l £2? acters or less • 
entry po?nt ^ Po^SuXt ^/f;"^!^ b * ^ MR 
entry p 01 nt of Interrupt Routine, (f^ecess^. 
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D.4.2.1 A Sample Program for Header and Linkage Block 



This section gives an example of the Header and Linkage Block in a typical 
DSR. The syntax of DX10 Assembler is obeyed in this program. DX10 Assembler 
Language is similar to, but not identical with, the TI Editor/Assembler. 
Information on the language can be found in the 9900 Family Design Book , 



Sample Program Showing DSR Header Format 



RORG >4000 
BYTE >AA 
BYTE 1 
DATA 0 
DATA PWRLNK 



DATA 0 
DATA DSRLNK 

DATA 0 
DATA INTLNK 

DATA 0 



start of DSR 

telling console this is a valid DSR 

version number, always 1 

not used in DSR calls; leave it 0 

Power-up Routines 1 Link. PWRLNK is 

replaced by 0 if power-up set is not 

necessary 

not used in DSR calls; leave it 0 
DSR link; can't be 0 here 
not used in DSR calls; leave it 0 
Interrupt Routine's Link. INTLNK is 
replaced by 0 if interrupt is not used 
not used in DSR calls; leave it 0 



★ 
★ 

PWRLNK 



*** This Power-up Routine can be omitted if power-up 
*** initialization is not necessary for this peripheral 



DATA 0 
DATA PWRUP 
BYTE 0 
EVEN 



linkage, set to 0 

entry point of power-up routine 

name length; set to 0 



PWRUP 



entry of power-up routine 



★ 

★ 

★ 

INTLNK 



B 



*R11 



return to console software through Rll, 
if it is not destroyed 



*** This Interrupt Routine can be omitted if Interrupt 
*** Request is never issued by this peripheral 



DATA 0 
DATA INTDSR 
BYTE 0 
EVEN 



linkage; set to 0 

entry point of the Interrupt Routine 
name length; set to 0 1 
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Sample Program (continued) 



INTDSR 



INTEND B 



* 

* 

* 
* 

* 

DSRLNK 



0SRLK2 



DSRLK3 



ENTRY1 



ENTRY2 



ENTRY3 



EXIT 



*R11 



entry of interrupt routine: 

IF interrupt request from this 

peripheral = true 
THEN begin interrupt service; 

reset interrupt request; 

GOTO INTEND 

END 

ELSE GOTO INTEND 

return to console software through Rll, 
if it is not destroyed 



*** Main Device Service Routine. Assuming three devices, 
*** with names DEVICE, DEVICE/1, DEVICE/2, are 
*** supported in this peripheral. 



DATA 
DATA 
BYTE 
TEXT 
EVEN 
DATA 
DATA 
BYTE 
TEXT 
EVEN 
DATA 
DATA 
BYTE 
TEXT 
EVEN 



DSRLK2 
ENTRY1 
6 

'DEVICE' 

DSRLK3 
ENTRY2 
8 

'DEVICE/1 
0 

ENTRY3 
8 

'DEVIC/2' 



INCT Rll 
B *R11 



linkage to next device field 
entry point of 1st device 
name length of 1st device 
name of 1st device 

linkage to next device field 
entry point of 2nd device 
name length of 2nd device 
name of 2nd device 

linkage to next device field (none) 
entry point of 3rd device 
neme length of 3rd device 
name of 3rd device 



entry of 1st device servicing 



entry of 2nd device servicing 



entry of 3rd device servicing 



return to console software through 
* Rll, if it is not destroyed 
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D.4.3 Power-Up Routine 



For some peripherals, it is necessary to initialize the hardware at power-up 
time- It is suggested that a power-up routine be included to do the 
initialization through software for these peripherals. Power-up Link should 
be set in the Header Field as described above. 

Power-up routines are executed whenever the system is reset by either hardware 
or software. The console software searches all peripheral DSR for power-up 
routine addresses and executes them if they are found. Each power-up routine 
can use R0-R10. Upon entry, R12 is set to the beginning address of the CRU 
space for that peripheral DSR (note that this address is used to enable the 
DSR ROM) . Rll contains the return address. R13 and R15 contain the 
memory-mapped addresses of GROM Read Data and VDP Write Address, 
respectively. All VDP and GROM operations can be indexed from these two 
registers. The power-up routine may use VDP RAM from 0 to the location 
pointed by CPU RAM >70, offset from workspace pointer - >E0). It can use all 
CPU RAM except location >55, <6D, and >C0 through >DF offset from workspace 
pointer - >E0. 

All power-up routines must return with B *R11. 
D.4.4 Interrupt Routine 

If the peripheral issues Interrupt Request to the 9900 CPU, the DSR should 
also include an interrupt routine and Interrupt Link in the Header as 
described above. Every interrupt that is not recognized as console interrupt 
(VDP or 9901 Timer) causes the console software to execute every interrupt 
routine it can find. The interrupt routine must check to see whether the 
Interrupt Request is raised by this peripheral. If it is not, exit by 
B *R11. 

The interrupt routine may use R1-R8, and RIO. The contents of R11-R15 are the 
same as those of the Power-up Routine Section. The interrupt routine and Main 
DSR can split the allocation of CPU RAM from >4A to >6D offset from workspace 
pointer - >E0 ) . 

All interrupt routines end with B *R11. Interrupt Request raised by the 
peripheral must be cleared before exit. 

To exit DSR, do 

INCT Rll 
B *R11 



GLOSSARY 



ALU 
bit 
byte 

cartridge 



memory 



CPU 

CRU 



DRAM 
DSR 



GPL 
GROM 



I/O 

LSB 

LSBY 

MMD 

MSB 

MSBY 

MPU 

PAB 

PC 

PCB 

PEU 



Arithmetic Logic Unit. 

Smallest unit of memory; Binary digiT 

8 bits of memory. 



ROM space found within a plug-in cartridge. 
Central Processing Unit. 

Communication Register Unit (I/O techique for TMS 9900 
Microprocessor). 

Dynamic Random Access Memory. 

Device Service Routine (TMS 9900 machine language for 
Device Interface). 

Graphics Programming Language. 

Graphics Read-Only Memory (TMC 0430). This memory device 
is a 6144 byte read-only memory with on-board 13-bit 
program counter. The program counter can be written or 
read through an 8-bit interface and will automatically 
increment. 

Input/Output. 
Least Significant Bit. 
Least Significant Byte. 
Memory-Mapped Device. 
Most Significant Bit. 
Most Significant Byte. 
Microprocessor Unit. 

Peripheral Access Block. 
Program Counter. 
Printed Circuit Board. 
Peripheral Expansion Unit. 
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RAM 
ROM 
SRAM 
VDP 



Random Access Memory. 

Read-Only Memory. 

Static Random Access Memory. 

Video Display Processor (TMS 9918A) 



WORD 



16 bits/2 bytes of memory 
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